Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Creating File Previews /

MakeFilePreview

The MakeFilePreview function creates a preview for a file. You should create a preview whenever you save a movie. You specify the file by supplying a reference to its resource file. You must have opened this resource file with write permission.

pascal OSErr MakeFilePreview (short resRefNum,
                              ProgressProcRecordPtr progress); 

resRefNum

Specifies the resource file for this operation. You must have opened this resource file with write permission. If there is a preview in the specified file, the Movie Toolbox replaces that preview with a new one.

progress

Points to a progress function. During the process of creating the preview, the Movie Toolbox may occasionally call a function you provide in order to report its progress. You can then use this information to keep the user informed.

Set this parameter to -1 to use the default progress function. If you specify a progress function, it must comply with the interface defined for Image Compression Manager progress functions (see the chapter "Image Compression Manager" in this book for more information). Set this parameter to nil to prevent the Movie Toolbox from calling a progress function. (For details on application-defined progress functions, see "Progress Functions," which begins on page 2-333.)

DESCRIPTION

If there is a preview in the specified file, the Movie Toolbox replaces that preview with a new one.

ERROR CODES

paramErr

-50

Invalid parameter specified

File Manager errors
Memory Manager errors
Resource Manager errors